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RESTARTM Reel checkpoint and restart 15-SEP-1984 23:37:37 VAX/VMS Macro v04-00 Page 1 
v04-000 . Fat et 1 33:30:37 YBACKUP. SREJRESTARTM.MAR: 1 . (1) | 
TITLE RESTART Reel checkpoint and restart 
-IDENT ‘v04-000' 


COPYRIGHT (c) 1978, 1980, 1982, 1984 BY 
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS. 
ALL RIGHTS RESERVED. 


* ® 
® oe 
* a 
® ® 
* ‘is 
° OFTWARE I$ FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED * 
© N ACCORDANCE WITH TH SUCH LICENSE AND WITH THE ® 
* ION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER ®* 
® THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY * 
* PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY * 
* TRANSFERRED. " 
ty ® 
* THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE * 
* AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT * 
* CORPORATION. . 
& ® 
Ls * 
® ® 
te * 
® * 
*® * 


DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS 
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 
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++ 
; FACILITY: 
; Backup/Restore 


; ABSTRACT: 
: This module contains routines to save and restore the low-level machine 
state for reel checkpoint and restart. 


; ENVIRONMENT: 
: VAX/VMS user mode. 
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, ; AUTHOR: M. Jack, CREATION DATE: 30-May-1981 
6 ; MODIFIED BY: 
0 v03-001 MLJ0090 Martin L. Jack, 7-May-1982 13:26 
Repair reel restart. 
v02-001 MLJ0054 Martin Jac 


gato 1961 22:24 


r i. k, 
Integrate GET_VM and FREE_VM jacket routines. 
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4 Checkpoint machine state BACKUP.SRCJRESTARTM.MAR; 1 
~SBTTL CHECKPOINT_M Checkpoint machine state 
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+ 
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Functional Description: 
This routine ehochpornts a low-level machine state so that we can 
later restart at t same point. 


Cotting Se uence: 
ALLS/CALLG 


Input Parameters 
4(AP) = CHKPT HIGH_SP 
B8(AP) = Address of CHKPT_STACK 
12(AP) = Address of CHKPT~LOW_SP 
; Implicit Inputs: 
none 
Output Parameters: 
none 
Implicit Outputs: 
none 
Routines Called: 
GET_VM 


Routine Value: 
n 


Signals: 
none 


Side Effects: 
none 
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; Compute the git torense between the saved frame pointer in the global 
: variable CHKPT_HIGH_ SP and CHKPT_LOW_SP. This value is the length 


OF FC ENTRY CHECKPOINT_M,*M<R2,R3,R4,R5,R6,R7,R8,R9,R1I0,R11> 
O65 ; The ante mask specifies all registers so that when the RET in 
3 RESTART_M executes, all registers are restored. 
: Save the frame pointer in the global variable CHKPT_LOW_SP. 
oc ec SD 00 00 2 ; MOVL =~ FP, a@12( AP) ; Save stack base pointer 
6 
é 


OOOooooceo 


of the Ai at of stack that ites besaved. It includes the stack 
frame for this routine. 
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56 04 AC 7D MOVQ 4(AP) ,R6 : fe s = CHKPT_HIGH_SP 
Address of CHKPT_STACK 
yy & @ @ SUBL3 FP,R6,-(SP) : Compute size of stack to save 
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Copy the stack area to the iecoadl memory, and return. 
poycs (SP), (FP) ,a(R7) ; Save the stack area 
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v04-000 CHECKPOINT M Checkpoint ma machine state 4-SEP=1 1984 33:85:35 YBACKUP. SREIR ESTARTM.MAR; 1 ~ By 
E 8 ; Allocate the dynamic memor cad hi address of the allocated 
E : space in the global variable CHKPT_STAC 
F DD 7 , PUSHL (SP) Copy size of stack to save 
00000000 ' GF F 0 CALLS #1, °GOGET VA Llocate space to hold saved stack 
67 0 oD if 1 MOVL RO, (R7) Bkte address in CHKPT_STACK 
1A 488 
1A 4 
1A 5 
O1F 6 
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RESTARTM Reel checkpoint and restart 15-SEP-1984 23:37:37 VAX/VMS Macro Vv04-00 Pa 4 
v04-000 RESTART_M PRestart given saved machine s reeset 7 33:80:30 BACKUP. SRCJRESTARTM.MAR; 1 aad (3) 
9 ! § ~SBTTL RESTART_M Restart given saved machine state | 
! p++ 
1 : : Functional Description: 
133 3 his routine restarts using the low-level machine state that was saved 
4 | 4 ; by CHECKPOINT_M. 
1 : : Calling Sequence: 
8 8 ' 8 : ALLS/CALLG 
8 0 139 : Input Parameters: 
0 140 ; O4(AP) = CHKPT_LOW SP 
020 141 ; O8(AP) = CHKPT~HIGA_SP 
Bo 8 136 : 12(AP) = Address of CHKPT_STACK 
0020 144 : Implicit Inputs: 
a rd 
60 0 147 : Output Parameters: 
00590129 none 
0020 150 : Implicit Outputs: 
8050182 wane 
0020 138 + Routines Called: 
LG Ean 
$659 156 : Routine Value: 
33 i 
0090 159 ; Signals: 
$090 161 none 
0020 16¢ : Side Effects: 
0020 163; none 
ith 164 ; 
6050 16g 
0000 On5 +4 ENTRY RESTART_M, “M<> ; Register save irrelevant 
$05 14 ; Compute the difference between the saved frame pointer in the global 
002 170 ; variable CHKPT_HIGH SP and CHKPT LOW SP. This value is the length 
3 4 : of the section of stack that will be restored from the saved copy. 
56 O08 AC 7D 00 158 P MOVQ = BAP) , R6 : R6 = CHKPT_HIGH_SP 
6 174 ; R? = Address of CHKPT_STACK 
56 O04 AC (C2 3 . Ha SUBL2 4(AP),R6 3; Compute Length of saved area 
3 A 173 : Now restore the FP and SP registers to the volues they had on entry to 
A 178 3 routine CHECKPOINT_M. Then, copy the saved section of stack to the 
0O2A 179; stack. This restores the stack to the exact state that it was 
O2A 180; in on entry to routine CHECKPOINT_M, It is important not to cause 
0 ‘ ' 13 any signals or other stack activity during these three instructions. 
5D 04 AC 00 o cs : . MOVL 4 (AP),FP ; Restore stack pointers 
5E 5 dO E 184 MOVL FP,SP : 
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RESTARTM Reel checkpoint and restart 15=SEP=1984 23:37:37 VAX/VMS Macro Vv04-00 Page 
vOe-000 RESTART_M PRestart given saved machine s axSEp- 1986 33:80:30 BACKUP. SRC IJRESTARTM.MAR; 1 ’ (3) 
6D 0087 56 28 a03¢ 183 MOVCS R6,a(R7), (FP) ; Restore stack 

60 6 189 ; The following RET instruction executes in the context of routine 

0036 188 ; CHECKPOINT_M, because the stack has been restored, and returns to 

0036 189 ; the caller of routine CHECKPOINT_M. The previous execution flow has 

O06 139 ; been entirely lost. 

04 00 . 2° RET ; Return to caller of CHECKPOINT_M 
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RESTARTM Reel checkpoint and restart 15-SEP-1984 23:37:37 VAX/VMS Macro V04-00 Pa 
Symbol table 27 b= 1382 33:35 :3) BACKUP. cat JRESTARTM.MAR; 1 ” 


CHECKPGINT_M 00000000 a 0 
GET_vM terrerer 1 
RESTAST_M 00000020 RG. 1 
tom nae eee we woe me + 
! ; Psect synopsis ; 
PSECT name Allocation PSECT No. Attributes 
ABS. 00000 amet 3-3 00 0.) NOPIC USR CON ABS LCL NOSHR NOEXE NORD NOWRT NOVEC BYTE 
ODE 000000 5 NOPIC USR CON REL LCL NOSHR EXE RD NOWRT NOVEC BYTE 
' {Performance indicators ! 
Phase Page faults CPU Time Elapsed Time 
Initialization 3 00:00:00.08 8:80:00 -86 
pounend processing 8 00:0 $28 -$¢ 0:00:03.16 
2 Bae 700.44 0: Hee 
Syabol table sort Ba! :00 00:00:0 0? 
Pass 2 5 :0 P+ 8: 0:01.34 
Symbol table output b's -0 0:00:00.01 
Psect synopsis output 1 0:00:00.02 00:00:00.09 
Cross-reference output 8 BB: 80:04 85 Be Soa 
Assembler run totals 23 0:00:01.50 0:00:07.60 


The working set Limit ues 750 pages. 
2036 bytes (4 pages) of virtual memory were used to buffer the intermediate code. 
There were 10 pages of symbol table space Sh yeces d to hold 3 non-local and 0 local symbols. 
194 source Lines were read in Pass 1, "ain't object records in Pass 2. 
pages of virtual memory were used to define 0 macros. 
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Macro Library name Macros defined 
“S255SDUAZB:(SYSLIBISTARLET.MLB;200 (tS 0 
0 GETS were required to define 0 macros. 

There were no errors, warnings or information messages. 
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